home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / util1 / arjbak12.zip / ARJBACK.DOC next >
Text File  |  1993-04-05  |  10KB  |  241 lines
  1.  
  2.                                     ARJBack
  3.  
  4.                                                 Version 1.2
  5.  
  6.                                                 by Gary Chanson
  7.  
  8.  
  9.              ARJBack  is Copyright 1993  by Gary Chanson  and Starquest
  10.              Systems.  No restrictions are placed on the non-commercial
  11.              use of this program.   This program  and its documentation
  12.              may be copied  and re-distributed  provided that they  are
  13.              not changed  and no fee is charged for them.  An exception
  14.              is granted  to  not-for-profit  user's  groups,  which are
  15.              authorized  to charge  a nominal  fee  for  materials  and
  16.              handling.
  17.  
  18.     Description:
  19.  
  20.         ARJBack  is a menu-driven front end for hard disk backups using the
  21.         archive  utility  ARJ.   ARJ  supports  disk  backups  to  multiple
  22.         floppies with many powerful options.  A major impediment to the use
  23.         of  this system  for  many users  is remembering  the multitude  of
  24.         command line switches  required to enable the  appropriate options.
  25.         ARJBack answers this limitation by providing a menu-drive interface
  26.         which can be controlled from the keyboard or a mouse.  A batch file
  27.         called ARJRSTOR.BAT is also provided for restoring a hard disk from
  28.         a set of ARJ backup files.
  29.  
  30.  
  31.     Installation:
  32.  
  33.         To install ARJBack,  copy the distribution files to a sub-directory
  34.         on the DOS search path.  If you create a new sub-directory for this
  35.         program,  you should also add this directory to the PATH= statement
  36.         in  AUTOEXEC.BAT.   ARJBACK.MEN  must be  in the same directory  as
  37.         ARJBACK.EXE  or it  will not  be found.   ARJ.EXE  version 2.30  or
  38.         higher  must also be available  for this program to operate.  Prior
  39.         versions  do not support  some of  the options  used  and may react
  40.         unpredictably to their use.
  41.  
  42.  
  43.     Usage:
  44.  
  45.         To run, enter:
  46.  
  47.             ARJBACK [srce_path] [dest_path]
  48.  
  49.         If  no source path  is entered,  the current directory  will be the
  50.     default  path.    If  no  destination  path  is  entered,  the  default
  51.     destination is A:\.
  52.  
  53.         ARJBack  will then display the menu and turn on the mouse cursor if
  54.     a mouse is available.  Menu selections can be activated by pressing the
  55.     indicated key or by moving the mouse until the mouse cursor is over the
  56.     desired  selection  and then  pressing  the  left button  on the mouse.
  57.     Pressing the right button aborts the program.
  58.  
  59.  
  60.         ┌──────────────────────────ARJBack───────────────────────────┐
  61.         │ S>  Source                            D:\PROJECTS\ARJBACK\ │
  62.         │ D>  Destination                                        A:\ │
  63.         │ W>  set drive for Work files                           E:\ │
  64.         │                                                            │
  65.         │ N>  archive file Name                             01-04-93 │
  66.         │ I>  Index file                             C:\01-04-93.INX │
  67.         │ V>  Volume size                                            │
  68.         │ X>  split files between volumes                         no │
  69.         │                                                            │
  70.         │ M>  backup Mode                                  all files │
  71.         │ H>  include Hidden and system files                     no │
  72.         │ A>  clear source file Archive attribute                yes │
  73.         │ T>  Test work files for errors                         yes │
  74.         │                                                            │
  75.         │ E>  Execute command before each volume                     │
  76.         │ C>  enter Commands between volumes                      no │
  77.         │ F>  Format destination disks                            no │
  78.         │ P>  Pause between volumes                              yes │
  79.         │                                                            │
  80.         │ K>  save configuration                                     │
  81.         │ R>  Restart interrupted backup                             │
  82.         │ G>  Start backup                                           │
  83.         └────────────────────────────────────────────────────────────┘
  84.                            figure 1 - ARJBack menu.
  85.  
  86.  
  87.     S>  Source
  88.  
  89.         Sets the source directory from  which all files and sub-directories
  90.         will be  backed up.   When  selected,  the  current source  will be
  91.         displayed and you will be prompted for a source path.  You can edit
  92.         the  displayed  string  or press  ESC  to clear it  to enter  a new
  93.         string.
  94.  
  95.     D>  Destination
  96.  
  97.         Sets  the destination  directory  from  which  all files  and  sub-
  98.         directories  will  be  backed  up.    When  selected,  the  current
  99.         destination  will be  displayed  and  you  will be  prompted for  a
  100.         destination path.  You can edit  the displayed string  or press ESC
  101.         to clear it to enter a new string.
  102.  
  103.     W>  Set drive for work files
  104.  
  105.         Sets the path for ARJ work files.  If your system has a RAM disk at
  106.         least as large  as the destination disk,  you should enter its path
  107.         here.  If an environment variable named  TEMP  exists, ARJBack will
  108.         set  the work drive  automatically.  If  the destination  is a hard
  109.         disk, no work drive should be specified.
  110.  
  111.     N>  Archive file Name
  112.  
  113.         Sets  the name  of the archive file  created.  If no extension  is
  114.         specified, .ARJ is used for the first volume  and .Ann is used for
  115.         subsequent volumes.  If  the extension .000 is  specified, 3 digit
  116.         index numbers are used.
  117.  
  118.     I>  Index file
  119.  
  120.         Sets the  name and path  of the index file.  This file will record
  121.         the contents of each volume created by ARJ and can be used to find
  122.         individual files when needed.  Enter a blank string to disable the
  123.         index file option.
  124.  
  125.     V>  Volume size
  126.  
  127.         Sets  the size  for each  volume.  If  no size  is specified,  ARJ
  128.         will  automatically  set it  to the size  of the destination disk.
  129.         Standard  disk sizes  are 360, 720, 1200, and 1440.   Other  sizes
  130.         must be specified in bytes.  100K is the same as 100000.     
  131.  
  132.     X>  split files between volumes
  133.  
  134.         If this option is enabled, ARJ will fill each volume and split the
  135.         last file in each volume between it and the next volume.
  136.  
  137.     M>  backup Mode
  138.  
  139.         Backup modes  are  `all files',  `changed files'  (files  with the
  140.         archive attribute set) and  `newer files' (files with  date stamps
  141.         newer than in an existing destination archive).
  142.  
  143.     H>  include Hidden and system files
  144.  
  145.         If  this  option  is enabled,  hidden  and  system  files  will be
  146.         included.  With  it disabled,  selective backups  can be  done  by
  147.         setting  the Hidden  attribute  on  the files  and sub_directories
  148.         which should be excluded.
  149.  
  150.     A>  clear source file Archive attribute
  151.  
  152.         If this option  is enabled, ARJ will  reset the archive attributes
  153.         on all backed up files.
  154.  
  155.     T>  Test work files for errors
  156.  
  157.         If this option is enabled, ARJ  will do a CRC test of each file in
  158.         each volume  before writing  the volume to  the destination  disk.
  159.         After writing the volume to the destination disk, ARJ will read it
  160.         back and compare it to the work file to assure it integrity.  This
  161.         option takes considerable time, but is highly recommended!
  162.  
  163.     E>  Execute command before each volume
  164.  
  165.         If a command is specified, it will be executed  before each volume
  166.         (after the "next volume" prompt).
  167.  
  168.     C>  enter Commands between volumes
  169.  
  170.         If this option is enabled,  ARJ will pause between volumes and run
  171.         COMMAND.COM.  You can enter  any commands required.  Enter EXIT to
  172.         continue backup.
  173.  
  174.     F>  Format destination disks
  175.  
  176.         If this option  is enabled,  ARJ will  format the destination disk
  177.         before creating each volume.
  178.  
  179.     P>  Pause between volumes
  180.  
  181.         If this option  is enabled, ARJ will pause  before each volume and
  182.         wait for a response.
  183.  
  184.     K>  save configuration
  185.  
  186.         If this function is selected, the current configuration will be
  187.         save as the default configuration.
  188.  
  189.     R>  Restart interrupted backup
  190.  
  191.         If ARJ  is unable to  write a volume  to the  destination disk, it
  192.         will terminate  the operation.  If this happens, you can  use this
  193.         option to restart it.  You will first  be prompted for  the volume
  194.         number to restart at.  This should be the number  of the volume in
  195.         which the error occurred.  Then you will be prompted  for the name
  196.         of the file  to restart at  followed by the offset  into the file.
  197.         You can find this information  by inspecting the  BACKUP.INX file.
  198.         Enter both the file name and the offset  exactly  as it appears in
  199.         the index file.
  200.  
  201.     G>  Start backup
  202.  
  203.  
  204.     Warning:
  205.  
  206.         It is quite possible  to generate a command line  too long to pass
  207.         to ARJ.EXE  by selecting  too many options  or by specifying  long
  208.         commands.   If ARJ  fails to operator  or performs strangely,  try
  209.         removing commands or specifying fewer options.
  210.  
  211.  
  212.     Restoring:
  213.  
  214.         ARJRSTOR.BAT  is provided  for restoring  drives  backed up  using
  215.         ARJBack.  To restore, enter:
  216.  
  217.             ARJRSTOR source [destination]
  218.  
  219.         To restore individual files,  examine the index file  to determine
  220.         which volume  contains the desired files,  and use ARJ  to extract
  221.         them.
  222.  
  223.     ----------------------------------------------------------------------
  224.  
  225.     For more information, please refer to ARJ.DOC which is part of the ARJ
  226.     distribution package.
  227.  
  228.     ----------------------------------------------------------------------
  229.  
  230.             Please forward all comments and bug reports to:
  231.  
  232.                 Gary Chanson
  233.                 Starquest Systems
  234.  
  235.                 31 Chester Avenue
  236.                 Waltham, MA  USA  02154
  237.  
  238.                 Voice:  617-899-4771
  239.  
  240.                 Email:  BCS-ZiTel BBS - 617-965-7046
  241.